home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat11 / adoc / adoc.doc < prev    next >
Encoding:
Text File  |  1992-08-21  |  25.3 KB  |  529 lines
  1.  
  2.  
  3. AboutThisDoc
  4.    
  5.           Ce manuel décrit la version 1.00 de l'utilitaire ADoc2. Ce  programme
  6.   est placé dans le domaine public, avec autorisation de le copier librement et
  7.   de le diffuser par n'importe quels moyens, à condition que  le  produit  soit
  8.   diffusé  dans  son  intégralité,  et  sans  aucune  modification.  ADoc   est
  9.   (c)1990-1991-1992 par Denis GOUNELLE, toute utilisation commerciale ou  vente
  10.   de ce programme sans autorisation écrite est STRICTEMENT INTERDITE.
  11.  
  12.           "PowerPacker 2.3b"  est  (c)1989  par  PowerPeak  et  Nico  FRANCOIS,
  13.   "PowerPacker Pro 3.0b" est (c)1990 par PowerPeak  et  par  UGA  Software.  La
  14.   bibliothèque "powerpacker.library" est (c)1990 par Nico FRANCOIS.  AREXX  est
  15.   (c)1987 par William Hawes.
  16.  
  17.           Malgré de nombreux tests, je ne peux  garantir  qu'ADoc  ne  contient
  18.   aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS  RISQUES  ET  PERILS.  Je  ne
  19.   pourrai en aucun cas  être  tenu  responsable  de  tout  dommage,  direct  ou
  20.   indirect, résultant de l'utilisation d'ADoc.
  21.  
  22.                    >>> FERMEZ CETTE FENETRE POUR CONTINUER <<<
  23.    
  24. Introduction
  25.    
  26.           ADoc2  est  une  nouvelle  version  de  ADoc,  qui  a  été   ré-écrit
  27.   entièrement afin de supprimer certaines limitations  et  de  pouvoir  ajouter
  28.   plusieurs améliorations. Notez que certaines incompatibilités sont  apparues,
  29.   notamment au niveau des arguments. Ce programme fonctionne de la  même  façon
  30.   sous les versions 1.3 et 2.04 du système.
  31.  
  32.           ADoc est un utilitaire permettant de  gérer  des  documentations  sur
  33.   n'importe quel sujet. Il est capable de lancer automatiquement  la  recherche
  34.   d'un mot désigné à la souris, et peut travailler sur plusieurs fichiers à  la
  35.   fois. ADoc peut  également  utiliser  directement  les  fichiers  AutoDoc  de
  36.   Commodore,  ainsi  que  des  fichiers  compactés  à  l'aide  de  l'utilitaire
  37.   "PowerPacker".
  38.  
  39.           Vous pouvez me faire part de vos remarques ou critiques sur ADoc,  en
  40.   écrivant à l'adresse suivante :
  41.  
  42.                                 M. GOUNELLE Denis
  43.                                     Boite 71
  44.                                6, rue des cailloux
  45.                               92110 CLICHY - FRANCE
  46.    
  47.           Merci à Jean-Yves PROUX et à Helmut J. ESENWEIN pour leurs nombreuses
  48.   suggestions, ainsi qu'à Simon HEWINSON  pour  la  traduction  en  anglais  du
  49.   fichier "amiga.doc". Remerciements particuliers à Jean-Philippe RAPP pour ses
  50.   idées, et pour m'avoir permis de tester ADoc sur les fichiers AutoDoc.
  51.  
  52. PrincipesDeFonctionnement
  53.    
  54.           ADoc travaille à partir de fichiers de documentation,  qui  associent
  55.   un texte à un mot-clé (appelé "terme" dans  cette  documentation).  A  chaque
  56.   fichier de documentation est associé un fichier d'index, qui permet d'accéder
  57.   presque  instantanément  aux  termes  recherchés  (notez  que  ceci  a   pour
  58.   conséquence  qu'il  faudra  reconstruire  le   fichier   d'index   à   chaque
  59.   modification du fichier de documentation). Seul le fichier d'index est chargé
  60.   en mémoire lors de l'utilisation. Le nom du fichier  d'index  est  obtenu  en
  61.   ajoutant le suffixe ".index" au nom du fichier de documentation.
  62.  
  63.           Les fichiers de documentation, que  vous  pouvez  créer  vous-même  à
  64.   l'aide de votre éditeur de texte  favori,  sont  constitués  d'une  série  de
  65.   définitions, chaque définition ayant la syntaxe suivante :
  66.  
  67.                   terme
  68.                           première ligne de texte
  69.                           seconde ligne de texte
  70.                            
  71.                           etc...
  72.                            
  73.                           n-ième ligne de texte
  74.    
  75.           Dans un premier temps, considérez que les deux  premières  lignes  du
  76.   fichier doivent être vides (ou à la rigueur commencer par un  espace  ou  une
  77.   tabulation). Il est absolument indispensable  que  le  premier  caractère  du
  78.   terme soit en colonne 1, et que les lignes de texte commencent par un  espace
  79.   ou une tabulation. Les lignes vides sont autorisées.
  80.  
  81.                                 NOTE IMPORTANTE :
  82.    
  83.       Le format des fichiers de documentation n'est plus le même  que  pour
  84.       les version 3.xx et 4.xx. 
  85.    
  86.           Un terme ne peut faire plus de 32 caractères, et ne peut contenir  ni
  87.   espaces ni tabulations : les caractères autorisés sont les lettres minuscules
  88.   et majuscules, les chiffres, le souligné et les caractères  accentués  (codes
  89.   ASCII compris entre 217 et 246). Il est cependant possible d'étendre  le  jeu
  90.   des caractères autorisés si besoin (voir paragraphe ConceptsAvancés). 
  91.           Le nombre de termes par fichier, et de lignes de texte par terme,  ne
  92.   sont pas limités (ou plutôt, cette limite est si  grande  que  vous  serez  à
  93.   court de mémoire bien avant).
  94.  
  95.           La longueur maximale d'une ligne de texte est de 256 caractères. Afin
  96.   de mettre en valeur certaines parties du  texte,  vous  pouvez  utiliser  les
  97.   séquences ANSI suivantes :
  98.  
  99.                   ESC[1m  début caractères gras
  100.                   ESC[3m  début caractères italiques
  101.                   ESC[4m  début caractères soulignés
  102.                   ESC[22m fin caractères gras
  103.                   ESC[23m fin caractères italiques
  104.                   ESC[24m fin caractères soulignés
  105.                   ESC[0m  caractères normaux
  106.    
  107. AppelDepuisLeCLI
  108.    
  109.   ADoc peut s'utiliser aussi bien depuis le CLI que depuis le  Workbench.  Dans
  110.   les deux cas, le fichier de documentation par  défaut  est  "Amiga.doc"  mais
  111.   vous pouvez évidemment choisir un autre fichier. Lors de  l'appel  depuis  le
  112.   CLI, vous pouvez indiquer les arguments suivants :
  113.  
  114.   WBENCH 
  115.       Demande à ADoc d'utiliser l'écran du Workbench. Si cet argument est omis,
  116.       ADoc ouvrira  son  propre  écran,  de  la  même  taille  que  l'écran  du
  117.       Workbench. En cas d'erreur lors de l'ouverture de cet écran, ADoc passera
  118.       automatiquement sur l'écran du Workbench.
  119.  
  120.   LACE 
  121.       Demande à ADoc d'utiliser un  écran  en  mode  entrelacé.  Si  vous  avez
  122.       demandé à utiliser l'écran du Workbench, et que cet écran  n'est  pas  en
  123.       mode entrelacé, cet argument sera ignoré.
  124.  
  125.   FONT nom 
  126.       Demande à ADoc d'utiliser la police de caractères indiquée, plutôt que la
  127.       police   par    défaut.    Le    nom    doit    être    de    la    forme
  128.       <NomDeLaPolice><TailleEnY>,  par  exemple  "topaz8".  ADoc  est   capable
  129.       d'utiliser n'importe quelle police non  proportionnelle,  pourvu  que  sa
  130.       taille soit d'au moins 8. 
  131.       Si ADoc ne peut ouvrir la police  demandée,  il  essayera  d'utiliser  la
  132.       police par défaut. Si cette police ne convient pas, ou si  ADoc  ne  peut
  133.       l'ouvrir, il essayera d'accéder à la police  Topaz,  en  taille  8.  S'il
  134.       échoue, le programme s'arrêtera immédiatement.
  135.  
  136.   MAKEIDX 
  137.       Indique à ADoc que la seule opération à effectuer  est  la  création  des
  138.       fichiers d'index.
  139.  
  140.   QUICK 
  141.       Demande  à  ADoc  de  ne  pas  afficher  le  texte   associé   au   terme
  142.       "AboutThisDoc" au démarrage. Normalement, à chaque fois que ADoc ouvre un
  143.       fichier, il cherche le terme "AboutThisDoc" dans ce  fichier  puis,  s'il
  144.       existe,  affiche le texte correspondant et attend que l'utilisateur ferme
  145.       la fenêtre pour continuer.
  146.  
  147.   AREXX 
  148.       Demande à ADoc de passer en mode  AREXX.  L'utilisation  avec  AREXX  est
  149.       détaillée au paragraphe ModeAREXX.
  150.  
  151.   NOCASE 
  152.       Demande à ADoc de ne pas différencier minuscules et majuscules lors de la
  153.       gestion des fichiers. Cela ne concernera que les fichiers dont le nom est
  154.       indiqué après cette option.
  155.  
  156.   NOSORT 
  157.       Demande à ADoc de ne pas trier l'index  des  fichiers  dont  le  nom  est
  158.       indiqué après cette option.
  159.  
  160.   TABSIZE n 
  161.       Indique la taille des tabulations pour  les  fichiers  dont  le  nom  est
  162.       indiqué après cette option. La taille par défaut est de 8. 
  163.    
  164.   Tout autre argument est considéré comme un nom de fichier de documentation  à
  165.   utiliser. Vous pouvez indiquer plusieurs fichiers, en séparant les  noms  par
  166.   des espaces ou par une virgule (par exemple "ADoc fichier1 fichier2" ou "ADoc
  167.   fichier1,fichier2"). Vous pouvez mélanger noms de fichiers et  options,  mais
  168.   n'oubliez pas que les options NOCASE, NOSORT, et TABSIZE ne concerneront  que
  169.   les fichiers indiqués après ces  options.  ADoc  ouvrira  les  fichiers  dans
  170.   l'ordre indiqué. A moins que vous n'indiquiez un chemin complet, les fichiers
  171.   sont recherchés d'abord dans le répertoire courant, puis dans  le  répertoire
  172.   "ADOC:". Si vous indiquez un nom de répertoire au lieu d'un nom  de  fichier,
  173.   tous les fichiers de ce répertoire (à l'exception  des  fichiers  ".info"  et
  174.   ".index") seront ouverts.
  175.  
  176. AppelDepuisLeWorkbench
  177.    
  178.   Depuis le Workbench, vous pouvez appeler ADoc de plusieurs façons :
  179.  
  180.     - en double-cliquant sur l'icône de ADoc (le fichier de  documentation  par
  181.       défaut sera utilisé) 
  182.     - en double-cliquant sur l'icône d'un fichier qui a ADoc  comme  outil  par
  183.       défaut (champ "DEFAULT TOOL") 
  184.     - en cliquant sur les icônes de plusieurs  fichiers,  tout  en  gardant  la
  185.       touche SHIFT appuyée, puis en double-cliquant sur l'icône de ADoc. 
  186.    
  187.   Dans tous les cas, ADoc commence par  examiner  le  champs  "TOOL  TYPES"  de
  188.   l'icône du programme, qui peut contenir :
  189.  
  190.       FONT=nom 
  191.       OPTIONS=[WBENCH][LACE][MAKEIDX][QUICK][AREXX]
  192.  
  193.   Pour plus de détails sur ces options, voir  le  paragraphe  AppelDepuisLeCLI.
  194.   Notez que les noms des options doivent être séparés  par  un  caractère  "|".
  195.   ADoc ouvre ensuite les  fichiers  de  documentation  éventuellement  indiqués
  196.   exactement de la même façon que lors de l'appel depuis le CLI (notamment vous
  197.   pouvez indiquer un répertoire au lieu d'un fichier), à la différence  que  le
  198.   champ "TOOL TYPES" de chaque icône est examiné, et peut contenir :
  199.  
  200.       TABSIZE=n 
  201.       OPTIONS=[NOCASE][NOSORT]
  202.  
  203.   Pour plus de détails sur ces options, voir  le  paragraphe  AppelDepuisLeCLI.
  204.   Notez que ces trois options ne concerneront que le  fichier  correspondant  à
  205.   l'icône.
  206.  
  207. DémarrageDuProgramme
  208.    
  209.           Comme expliqué dans les deux paragraphes  précédents,  ADoc  commence
  210.   par ouvrir le (ou les) fichier(s) indiqué(s). Lors de cette phase, ADoc tente
  211.   également de charger le fichier d'index correspondant  à  chaque  fichier  de
  212.   documentation. 
  213.           Si le fichier d'index est introuvable,  ADoc  vous  proposera  de  le
  214.   créer. Si vous refusez, ce fichier de documentation ne sera  pas  utilisable,
  215.   mais ADoc essayera quand même d'ouvrir les autres fichiers. 
  216.           Si ADoc détecte que le fichier de documentation a été  modifié  après
  217.   la création de l'index, il vous proposera de  mettre  le  fichier  d'index  à
  218.   jour. Si vous refusez, le fichier de documentation sera  quand  même  ouvert,
  219.   mais ADoc pourra détecter des erreurs ultérieurement  si  le  contenu  de  ce
  220.   fichier a été changé. Notez que la date de création du  fichier  d'index  est
  221.   mémorisée dans le fichier d'index lui-même.
  222.  
  223.           Une fois tous  les  fichiers  ouverts,  ADoc  affiche  une  boite  de
  224.   requête,  indiquant  la  liste  des  termes  du   premier   fichier   ouvert.
  225.   L'utilisation  de  cette  boite  de  requête  est   décrite   au   paragraphe
  226.   RequêteDeTerme.
  227.  
  228. RequêteDeTerme
  229.    
  230.           Vous pouvez désigner un terme à l'aide  de  la  souris,  en  cliquant
  231.   dessus. Le terme s'affiche alors dans une autre couleur. Si vous cliquez  une
  232.   seconde fois sur ce terme, la requête disparait  et  ADoc  affiche  le  texte
  233.   correspondant au terme dans une fenêtre. L'utilisation de  ces  fenêtres  est
  234.   décrite au paragraphe GestionDesFenêtres.
  235.  
  236.           Vous pouvez également vous servir du clavier pour faire votre  choix.
  237.   Si vous appuyez sur une lettre  quelconque,  cette  lettre  sera  ajoutée  au
  238.   "préfixe" courant (affiché dans le rectangle  en  dessous  de  la  liste  des
  239.   termes), et l'affichage de la liste des termes se fera à  partir  du  premier
  240.   terme commençant par ce préfixe. ADoc complètera ce préfixe le plus possible.
  241.   Si vous appuyez sur la touche <BACKSPACE> (au dessus de la touche  <RETURN>),
  242.   le dernier caractère du préfixe sera effacé et l'affichage de la liste mis  à
  243.   jour également. Si vous appuyez sur la touche  <RETURN>,  ADoc  affichera  le
  244.   texte correspondant au premier terme commençant par  le  préfixe.  Notez  que
  245.   ADoc ne différenciera pas  minuscules et majuscules si le fichier  courant  a
  246.   été indiqué après une option NOCASE.
  247.  
  248.           Vous pouvez fermer la requête sans rien choisir, en appuyant  sur  la
  249.   touche <ESC> ou en cliquant sur le  gadget  de  fermeture.  Si  aucune  autre
  250.   fenêtre n'est ouverte à ce moment, le programme s'arrêtera.
  251.  
  252.           La requête de terme est en fait capable de vous  permettre  un  choix
  253.   parmis trois listes : la liste des termes du fichier courant,  la  liste  des
  254.   fichiers (à condition qu'il y ait plusieurs fichiers ouverts) et la liste des
  255.   termes trouvés lors de la dernière recherche (à  condition  qu'une  recherche
  256.   ait déjà été effectuée, voir paragraphe Recherche). La lettre écrite dans  le
  257.   coin inférieur droit de la requête vous indique quelle liste est  affichée  :
  258.   liste des termes (T), liste des fichiers (F), liste des termes trouvés (S). 
  259.           Pour passer d'une liste à l'autre, appuyez sur le bouton droit de  la
  260.   souris tout en appuyant sur une des  touches  SHIFT.  Lorsque  la  liste  des
  261.   fichiers est affichée et que sélectionnez un des  fichiers  de  cette  liste,
  262.   ADoc repasse automatiquement à la liste des termes et affiche  la  liste  des
  263.   termes du fichier que vous avez choisi.
  264.  
  265.           Si aucune autre fenêtre n'est ouverte, la requête  de  terme  dispose
  266.   d'un menu avec trois options. La premiere vous permet de lancer une recherche
  267.   (voir paragraphe Recherche), la seconde vous permet  d'iconifier  ADoc  (voir
  268.   paragraphe LeMenuProjet) et la dernière vous permet de quitter ADoc.
  269.  
  270. GestionDesFenêtres
  271.    
  272.           Lorsque vous sélectionnez un  terme,  ADoc  ouvre  une  fenêtre  pour
  273.   afficher le texte correspondant. Si le terme est défini plusieurs  fois  dans
  274.   le même fichier, ou dans plusieurs fichiers différents, toutes les lignes  de
  275.   texte seront mises à la suite les unes des  autres,  et  affichées  dans  une
  276.   seule fenêtre. La hauteur  de  la  fenêtre  dépend  du  nombre  de  lignes  à
  277.   afficher. S'il y a trop de lignes, seule la première page  sera  affichée  et
  278.   ADoc ajoutera deux gadgets en forme de flèches (dans le coin supérieur droit)
  279.   à la fenêtre, pour vous permettre de faire défiler le texte.
  280.  
  281.           Bien entendu, il est possible d'avoir plusieurs fenêtres  ouvertes  à
  282.   la fois.  Par  défaut,  les  fenêtres  disposent  des  gadgets  standards  de
  283.   fermeture, de déplacement, de changement de plan, et de changement de taille.
  284.   Si  vous  modifiez  la  taille  d'une  fenêtre,  ADoc  ajoutera  ou  enlevera
  285.   automatiquement les gadgets en forme de flèches suivant les  besoins.  Chaque
  286.   fenêtre dispose également de trois menus, les  menus  "Projet",  "Outils"  et
  287.   "Spécial" (ces menus sont décrits aux paragraphes LeMenuProjet,  LeMenuOutils
  288.   et LeMenuSpécial). Notez enfin que vous pouvez fermer une fenêtre en appuyant
  289.   sur la touche <ESC>, et utiliser les touches <HAUT> et <BAS> du curseur  pour
  290.   faire défiler le texte page par page.
  291.  
  292.           Si vous cliquez sur un mot quelconque, ce mot sera affiché  dans  une
  293.   couleur différente. Si vous cliquez une seconde fois sur ce mot, ADoc lancera
  294.   automatiquement la recherche du terme correspondant, dans tous  les  fichiers
  295.   ouverts.  En  cas  d'échec  l'écran  flashera,  sinon  une  nouvelle  fenêtre
  296.   apparaitra.
  297.  
  298. LeMenuProjet
  299.    
  300.   Autre terme 
  301.       Fait apparaitre la requête de terme (voir paragraphe RequêteDeTerme).
  302.  
  303.   Imprime 
  304.       Imprime  le  texte  contenu  dans  la  fenêtre  active.  Notez  que   les
  305.       éventuelles  séquences  ANSI   seront   correctement   interprétées   par
  306.       l'imprimante.
  307.  
  308.   Iconifie 
  309.       Met ADoc en sommeil : si ADoc avait ouvert son propre écran celui-ci  est
  310.       fermé, puis toutes les fenêtres disparaissent et ADoc  ouvre  une  petite
  311.       fenêtre en haut de l'écran du Workbench. Si vous cliquez sur le gadget de
  312.       fermeture de cette fenêtre, ADoc vous  demandera  confirmation  avant  de
  313.       quitter. Pour "réveiller" ADoc, activez la  fenêtre  et  appuyez  sur  le
  314.       bouton droit de la souris. 
  315.       Normalement, ADoc garde en mémoire toutes les lignes  de  texte  afin  de
  316.       pouvoir remettre rapidement toutes les fenêtres  en  place  lors  de  son
  317.       réveil. Ceci a l'inconvénient de ne pas libérer toute la mémoire possible
  318.       aussi, lorsque vous lui demanderez de s'iconifier, ADoc vous demandera si
  319.       vous voulez fermer toutes les fenêtres. Si vous répondez oui, la  mémoire
  320.       sera complètement libérée, et lorsque vous réveillerez ADoc, il affichera
  321.       la requête de terme.
  322.  
  323.   A propos... 
  324.       Affiche quelques informations sur  ADoc.  Cliquez  à  l'intérieur  de  la
  325.       fenêtre ou appuyez sur une touche pour continuer.
  326.  
  327.   Quitter 
  328.       Vous permet de quitter ADoc (avec confirmation). 
  329.    
  330. LeMenuOutils
  331.    
  332.   Ecran avant 
  333.       Permet d'utiliser ADoc sur un écran déjà ouvert  (par  exemple  celui  de
  334.       votre éditeur de texte). Il vous suffit de mettre l'écran sur lequel vous
  335.       voulez placer ADoc au premier plan, puis de le faire glisser vers le  bas
  336.       pour dévoiler l'écran où est ADoc. Sélectionnez alors cette option : ADoc
  337.       ferme toutes les fenêtres ouvertes, ferme éventuellement  son  écran,  et
  338.       ré-ouvre les fenêtres sur l'écran au premier plan.
  339.  
  340.                                   NOTE IMPORTANTE :
  341.        
  342.           Vous aurez certainement droit à une visite du "Gourou" si l'écran
  343.           où vous avez placé ADoc est fermé avant que vous ayez quitté ADoc
  344.           (ou que vous l'ayez placé sur un autre écran) 
  345.        
  346.       Notez que cette commande ne marchera pas si vous n'avez  pas  indiqué  de
  347.       police de caractères à utiliser (voir paragraphe AppelDepuisLeCLI) et que
  348.       la police de l'écran au premier plan ne convient pas.
  349.  
  350.   Ferme tout 
  351.       Vous permet de fermer toutes les fenêtres  d'un  seul  coup.  Après  vous
  352.       avoir demandé confirmation, ADoc fermera les  fenêtres  et  affichera  la
  353.       requête de terme.
  354.  
  355.   Cherche 
  356.       Vous permet de lancer une recherche (voir le paragraphe Recherche).
  357.  
  358.   Information 
  359.       Affiche le nombre de fichiers et de  termes  disponibles,  ainsi  que  le
  360.       nombre de fenêtres ouvertes et de lignes affichées. Cliquez sur le gadget
  361.       "Ok" pour continuer. 
  362.    
  363. LeMenuSpécial
  364.    
  365.   Ouvre fichier 
  366.       Vous permet d'ouvrir un  fichier  de  documentation  supplémentaire.  Une
  367.       requête de fichier apparait afin que vous puissiez indiquer le fichier  à
  368.       ouvrir. Notez que les fichiers ".info" et ".index" ne sont  pas  affichés
  369.       dans cette requête.
  370.  
  371.   Ferme fichier 
  372.       Vous permet de fermer le fichier courant (c'est-à-dire le fichier où  est
  373.       défini le terme affiché dans la fenêtre active). Après vous avoir demandé
  374.       confirmation, ADoc fermera toutes les fenêtres correspondant à ce fichier
  375.       puis fermera le fichier. 
  376.       Notez que cette commande ne marchera que si au moins deux  fichiers  sont
  377.       ouverts. 
  378.    
  379. Recherche
  380.    
  381.           ADoc est capable de chercher  jusqu'à  quatre  chaines  simultanément
  382.   dans les lignes de texte, puis d'afficher la liste des termes correspondants.
  383.   Lorsque vous sélectionnez l'option "Cherche" du menu  "Outils",  une  fenêtre
  384.   apparait avec quatre gadgets de chaine. Il y a également un gadget  "ANNULER"
  385.   pour abandonner l'opération, un gadget "VALIDER" pour lancer la recherche, et
  386.   un menu "Options" :
  387.  
  388.       min = MAJ 
  389.           Demande à ADoc de ne pas différencier les minuscules  des  majuscules
  390.           lors de la recherche.
  391.  
  392.       Toutes chaines 
  393.           Normalement, ADoc cherche tous les termes  qui  contiennent  une  des
  394.           chaines que vous avez entré. Cette option vous permet de chercher  au
  395.           contraire les termes qui contiennent TOUTES les chaines indiquées.
  396.  
  397.       Tous fichiers 
  398.           Demande à ADoc de faire la recherche dans tous les fichiers  ouverts,
  399.           et non seulement dans le fichier courant. 
  400.    
  401.           Lorsque vous lancez la recherche, ADoc  fait  défiler  les  noms  des
  402.   termes au fur et à mesure. Le gadget "Arrêter" vous permet  d'interrompre  la
  403.   recherche. Une fois la recherche terminée, l'écran flashera  si  aucun  terme
  404.   n'a été trouvé. Sinon, la requête de terme apparaitra, et affichera la  liste
  405.   des termes trouvés. Cette liste est triée, et elle est conservée  en  mémoire
  406.   jusqu'à ce que vous lanciez une autre recherche.
  407.  
  408. ConceptsAvancés
  409.    
  410.           ADoc est capable d'associer  automatiquement  plusieurs  fichiers  de
  411.   documentation. Il vous suffit d'indiquer le (ou  les)  noms  des  fichiers  à
  412.   associer sur la première ligne du fichier auquel vous voulez les associer. Si
  413.   cette ligne reste vide, ou commence par un  espace  ou  une  tabulation,  son
  414.   contenu est ignoré. Les noms peuvent être séparés par des espaces ou par  une
  415.   virgule. Vous pouvez indiquer un nom  de  répertoire,  auquel  cas  tous  les
  416.   fichiers de ce répertoire  seront  ouverts  (sauf  les  fichiers  ".info"  et
  417.   ".index").
  418.  
  419.           Pour étendre le jeu des caractères  pouvant  être  utilisés  dans  un
  420.   terme, il vous  suffit  d'indiquer  les  caractères  supplémentaires  sur  le
  421.   seconde ligne du fichier de documentation. Si  cette  ligne  reste  vide,  ou
  422.   commence par un espace ou une tabulation, son contenu est ignoré. Sinon, tous
  423.   les caractères de cette ligne (jusqu'au premier espace, tabulation, barre  de
  424.   fraction ou saut de page) sont ajoutés au jeu de caractères par défaut. Notez
  425.   que cette extension du jeu de caractères ne concernera que ce fichier.
  426.  
  427.           ADoc est capable de charger directement des  fichiers  compactés  par
  428.   "PowerPacker", à  condition  que  la  bibliothèque  "powerpacker.library"  se
  429.   trouve dans le répertoire "LIBS:".  Il  n'est  pas  nécessaire  de  créer  le
  430.   fichier d'index avant le compactage, mais cela est recommandé. ADoc  refusera
  431.   de charger un fichier crypté. 
  432.           Après  décompactage,  le  fichier  sera  recopié  dans   un   fichier
  433.   temporaire placé dans le répertoire "T:". L'utilisation de fichiers compactés
  434.   peut donc poser des problèmes de mémoire, particulièrement si  le  répertoire
  435.   "T:" se trouve sur le disque "RAM:". Le fichier temporaire sera détruit après
  436.   sa fermeture.
  437.  
  438.           ADoc est capable de reconnaitre et d'utiliser les fichiers AutoDoc de
  439.   Commodore. Dans la plupart des cas, aucune modification de ces fichiers n'est
  440.   nécessaire, mais il est quand même conseillé de vérifier  leur  format  :  il
  441.   doit y avoir au moins deux lignes vides au début, suivies  de  la  table  des
  442.   matières, et chaque terme doit commencer en colonne 1. 
  443.           Dans certains cas, il manque les lignes vides au début, et les termes
  444.   commencent en colonne 2, précédés par un caractères "saut de page"  (CTRL-L).
  445.   Le programme "AutoConvert", distribué avec ADoc, vous permettra de  convertir
  446.   ces fichiers au bon format (Note: ce programme ne peut s'utiliser que  depuis
  447.   le CLI). Dans tous les autres cas, il vous faudra convertir les  fichiers  "à
  448.   la main".
  449.  
  450. ModeAREXX
  451.    
  452.           ADoc  ouvre  systématiquement  un  port   compatible   AREXX,   nommé
  453.   "ADoc_rexx". Les messages sur ce port sont attendus en  même  temps  que  les
  454.   messages Intuition sur les fenêtres de texte, et peuvent prendre  les  formes
  455.   suivantes :
  456.  
  457.           quit    quitte ADoc 
  458.           request fait apparaitre la requête de terme 
  459.           fscreen fait passer ADoc sur l'écran au premier plan 
  460.           ?terme  lance la recherche du terme  indiqué,  et  affiche  le  texte
  461.                   correspondant s'il est trouvé 
  462.    
  463.           Tout autre message sera ignoré. Voici un exemple de programme  AREXX,
  464.   qui demande de l'aide sur le terme "alias" :
  465.  
  466.           /* Demande de l'aide sur "alias" */
  467.           address "ADoc_rexx"
  468.           "?alias"
  469.    
  470.           Notez les guillemets autour des commandes ! 
  471.           Si vous  lancez  ADoc  avec  l'option  AREXX,  le  fonctionnement  du
  472.   programme sera un peu différent : une fois le(s) fichier(s) de  documentation
  473.   ouvert(s), ADoc n'ouvrira pas la requête de terme mais affichera  le  message
  474.   "En attente d'un message AREXX" et attendra des messages sur  le  port  AREXX
  475.   (ou CTRL-C pour quitter). De plus, lorsque la dernière fenêtre  sera  fermée,
  476.   le programme ne se terminera pas mais repassera en attente de messages AREXX.
  477.    
  478. LesMessagesDeADoc
  479.    
  480.           Lorsqu'une erreur se produit, ADoc affiche dans une petite fenêtre un
  481.   nom (de fichier en général) et un code d'erreur. Ce code d'erreur est soit un
  482.   code  d'erreur  AmigaDOS  soit  un  code  interne.  Dans  le   premier   cas,
  483.   reportez-vous à votre manuel de l'AmigaDOS (ou utilisez la commande  "Fault")
  484.   pour avoir plus de détails sur ce code d'erreur. 
  485.           Les codes d'erreur internes sont :
  486.  
  487.           -1      fichier vide
  488.           -2      erreur de lecture
  489.           -3      fichier incorrect (mauvais format, etc...)
  490.           -4      fichier compacté, et "powerpacker.library" absente
  491.           -5      problème lors du décompactage
  492.    
  493.           Vous pouvez répondre à toutes les requêtes de ADoc soit, normalement,
  494.   à la souris, soit à l'aide d'équivalents clavier  :  appuyez  sur  la  touche
  495.   correspondant à l'initiale du texte dans le gadget (par exemple  "o"  ou  "O"
  496.   pour "Oui"). Vous pouvez aussi appuyer  sur  <RETURN>  pour  sélectionner  la
  497.   réponse "positive" ou sur <ESC> pour sélectionner la réponse "négative".
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.